

    \filetitle{vline}{Add vertical line with text caption at the specified position}{grfun/vline}

	\paragraph{Syntax}\label{syntax}

\begin{verbatim}
[Ln,Cp] = grfun.vline(Xpos,...)
[Ln,Cp] = grfun.vline(H,XPos,...)
\end{verbatim}

\paragraph{Input arguments}\label{input-arguments}

\begin{itemize}
\item
  \texttt{'XPos}' {[} numeric {]} - Horizontal position or vector of
  positions at which the vertical line or lines will be drawn.
\item
  \texttt{H} {[} numeric {]} - Handle to an axes object (graph) or to a
  figure window in which the the line will be added; if not specified
  the line will be added to the current axes.
\end{itemize}

\paragraph{Output arguments}\label{output-arguments}

\begin{itemize}
\item
  \texttt{Ln} {[} numeric {]} - Handle to the vline(s) plotted (line
  objects).
\item
  \texttt{Cp} {[} numeric {]} - Handle to the caption(s) created (text
  objects).
\end{itemize}

\paragraph{Options}\label{options}

\begin{itemize}
\item
  \texttt{'caption='} {[} char {]} - Annotate the vline with this text
  string.
\item
  \texttt{'excludeFromLegend='} {[} \emph{\texttt{true}} \textbar{}
  \texttt{false} {]} - Exclude the line from legend.
\item
  \texttt{'hPosition='} {[} \texttt{'center'} \textbar{} \texttt{'left'}
  \textbar{} \emph{\texttt{'right'}} {]} - Horizontal position of the
  caption.
\item
  \texttt{'vPosition='} {[} \texttt{'bottom'} \textbar{}
  \texttt{'middle'} \textbar{} \emph{\texttt{'top'}} \textbar{} numeric
  {]} - Vertical position of the caption.
\item
  \texttt{'timePosition='} {[} \texttt{'after'} \textbar{}
  \texttt{'before'} \textbar{} \texttt{'middle'} {]} - Placement of the
  vertical line on the time axis: in the middle of the specified period,
  immediately before it (between the specified period and the previous
  one), or immediately after it (between the specified period and the
  next one).
\end{itemize}

\paragraph{Description}\label{description}

\paragraph{Example}\label{example}


